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APPENDIX A: 

The following is a header file for the interprocess 
communication (IPC) feature of MMLite. This is the 
interface for the loadable IPC. TPC.EXE registers an 
object that obeys this interface in the namespace, at the 
time IPC. EXE is loaded (on demand). The method of 
interest is the TrapHandler ( ) one, which is passed a 
pointer (pThreadState) to the machine-level register 
state of the thread. The method must infer from the 
state what is the operation the application intends to 
perform. For instance, some of the' operations that must 
be implemented by IPC. EXE are: 

- creation and destruction of endpoints 

- linking of endpoints (export/import) 

- remote method invocation. 

We do not specify these, they are specific of the 
particular style of IPC. For example, there might be a 
special value in one of the machine registers that indicates 
what operation is desired. 

#if defined ( cplusplus) 

extern "C" { 

■ 4 

#endif /* cplusplus */ 

typedef interface ILoadablelPC ILoadablelPC; 

typedef struct ILoadablelPCVtbl {• 
SCODE ( MCT *QueryInterface ) ( 
ILoadablelPC *This, 
/* [in] */ REFIID lid, 
/* [out] */ void **ppObject); 

UINT ( MCT *AddRef ) ( 
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ILoadablelPC *This) ; 

UINT ( MCT *Release ) ( 
ILoadablelPC *This) ; 

5 

SCODE ( MCT *TrapHandler ) ( 
ILoadablelPC *This, 

PCXTINFO pThreadState 

) ; 

10 

} ILoadablelPCVtbl; 

#if defined ( cplusplus) && ! defined (CINTERFACE) 

15 interface ILoadablelPC : public IUnknown 

{ 

public: 

virtual SCODE MCT TrapHandler ( 
PCXTINFO pThreadState 
20 ) = 0; 

}; 

#else /* cplusplus */ /* C style interface */ 

25 

interface ILoadablelPC 
{ 

CONST_VTBL struct ILoadablelPCVtbl *lpVtbl; 

}; 

30 

#endif /* cplusplus */ /* C style interface */ 



#if defined ( cplusplus) 

} 
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#endif /* cplusplus */ 

APPENDIX B: 

The following is a header file for the mutation (Imutate) 
5 feature of MMLite. This is the interface to the object 

mutation algorithm. The mutator thread invokes one of the 
two methods MutateObject or MutateVtable . The first is the 
general case, the second is a special case where the object 
state does not need to actually change. There might be 
10 other special cases, such as mutating a single method. The 
general case covers them all, it just. might be less 
efficient. This interface is registered in the namespace by 
the component that implements the mutation algorithm (s) . 
This is a loadable component. 

15 

#if defined ( cplusplus) 

extern "C" { 

#endif /* cplusplus */ 

20 typedef BOOL (MCT *TRANSITION_FUNCTION) ( 
IUnknown *pObj 

) ; 



25 



typedef interface IMutate IMutate; 



typedef UINT MUTATE__FLAGS ; 
#define MUTATE_AS_APPLICABLE (0x0) 
#define MUTATE_BY_MUTEX (0x1) 
#define MUTATE_BY_ABORT (0x2) 
30 #define MUTATE_BY_SWIZZLING (0x3) 
#define MUTATE BY STOMPING (0x4) 



typedef struct IMutateVtbl { 
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SCODE ( MCT *QueryInterface ) ( 
IMutate *This, 
/* [in] */ REFIID lid, 
/* [out] */ void **ppObject); 

5 

UINT ( MCT *AddRef ) ( 
IMutate *This) ; 

UINT ( MCT *Release ) ( 
10 IMutate *This) ; 

SCODE ( MCT *MutateVtable ) ( 
IMutate *This, 
IUnknown *pWho, 
15 struct IUnknownVtbl *pNewVtable, 

MUTATE_FLAGS dwFlags); 

SCODE ( MCT *MutateObject ) { 
IMutate *This, 
20 IUnknown *pWho, 

TRANS IT ION_FUNCT ION pTransition, 
MUT AT E_FLAG S dwFlags) ; 



25 



} IMutateVtbl; 
#if defined ( cplusplus) && ! defined (CINTERFACE) 



interface IMutate : public IUnknown 
{ 

30 public: 

virtual SCODE MCT MutateVtable ( 
IUnknown *pWho, 

struct IUnknownVtbl *pNewVtable, 
MUTATE_FLAGS dwFlags) = 0; 
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virtual SCODE MCT MutateObj ect ( 
IUnknown *pWho, 

T RAN S I T I ON_FUN C T I ON pTransition, 
5 MUT AT E_FLAG S dwFlags) = 0; 

}; 

#else /* cplusplus */ /* C style interface */ 

10 

interface IMutate 
{ 

CONST_VTBL struct IMutateVtbl *lpVtbl; 

}; 

15 

#endif /* cplusplus */ /* C style interface */ 

#if defined ( cplusplus) 

} 

20 #endif /* cplusplus */ 



Appendix C: 

25 The following is a header file of the virtual memory 

manager of MMLite. These are the 3 interfaces to the 
loadable virtual memory (VM) . [The IVmMapping interface 
is referred to above as VMMap . ] The fourth interface 
(VMFactory) is the one that is actually registered in the 

30 namespace; it contains the constructors for objects of 

the other 3 types. 

#ifndef MMVM H 
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#define MMVM H 



typedef struct IUnknown *PIUNKNOWN; 
typedef struct IFile *PIFILE; 
typedef struct IVmView *PIVMVIEW; 
typedef struct IVmSpace *PIVMSPACE; 
typedef struct IVmMapping *PIVMMAPPING; 



/* Basic types */ 
typedef UINT64 VM_0FFSET; 
typedef UINT64 VM_SIZE; 
typedef UINT32 VM_FLAGS; 

/* Other necessary types */ 

typedef struct _IPAGELIST *PIPAGELIST; 



/* VM_ FLAGS bit definitions */ 
# define VM_PROT_READ 1 
#define VM_PROT_WRITE 2 
#define VM_PROT_EXECUTE 4 
#define VM_COPYONWRITE 8 
#define VM_WIRE 0x10 
#define VM__NOCACHE 0x20 
cache, for i/o etc. */ 
#define VM_SHARE 0x4 0 

underlying VMSpace */ 
#define VM_PAGE_PRESENT 0x1000 
#define VM_ P AG E_ DIRTY 0x2000 
written and is writable */ 
#define VM_PAGE_BUSY 0x4 000 

and is unaccessible */ 
#define VM_ PAG E_W A I T I N G 0x8000 
for the busy page */ 



/* Lock memory in core */ 
/* Turn off hardware 



/* Recursion: Share mem 



w 



/* The page is in core */ 

/* The page has been 

/* Undergoing transition 

/* somebody is waiting 
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#define VM_ P AG E__ VT L B 0x10000 /* page has been looked 

up since VTLB_Flush */ 

#define VM_PAGE_MARK 0x20000 /* page has been touched 

(for pseudo-LRU) */ 

#define VM_FLAGS_MASK 0x7f /* Flags settable in vs- 

>Protect. */ 

/* Mapping */ 

/* A mapping object is used for providing backing storage 
for an 

* address space. A mapping object can map a file or 
another address 

* space (or whatever you can think of) . 

* A mapping object has an offset into the backing store 
object it maps, 

* a size, and a maximum protection. 

* Data 
*/ 

struct VmMappingVtbl { 

SCODE (*QueryInterface) (PIVMMAPPING This, REFIID lid, 
void **ppObject) ; 

UINT (*AddRef) (PIVMMAPPING This); 

UINT (^Release) (PIVMMAPPING This); 

/* Get pages from backing store. */ 
SCODE (*Read) (PIVMMAPPING This, VM_OFFSET Offset, 
VM_SIZE Size, 

PIPAGELIST *PageList); 

/* Write pages out into backing store */ 
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SCODE (*Write) (PIVMMAPPING This, VM_OFFSET Offset, 
VM_SIZE Size, 

BOOL Consume, PIPAGELIST PageList) ; 

/* Like read but shares pages instead of copying them 
(lookup func) . */ 

SCODE (*Share) (PIVMMAPPING This, VM_OFFSET Offset, 
VM_SIZE Size, 

VM_ FLAGS Access, PIPAGELIST *pPageList) ; 



/* Check protection of area in order to do checks at 
vm_prot time. 

* Returns lowest possible access combination 
(intersection) . 
15 */ 

SCODE (*QueryAccess) (PIVMMAPPING This, VM_OFFSET Offset, 
VM_SIZE Size, 

VM_FLAGS *pAccess); 

20 SCODE (*GetSize) (PIVMMAPPING This, VM_SIZE *pSize) ; 

/* Create a new mapping from this mapping with limited 
access */ 

SCODE (*Clone) (PIVMMAPPING This, VM_OFFSET Offset, 
25 VM_SIZE Size, 

VM_ FLAGS Access, PIVMMAPPING *pNewMapping) ; 

}; 

struct IVmMapping { 
30 CONST_VTBL struct VmMappingVtbl *v; 

}; 

extern const IID IID_IVmMapping; 
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/* Adress Space 

- */ 

struct VMSpaceVtbl { 

SCODE (*QueryInterface) (PIVMSPACE This, REFIID lid, void 
**ppObject) ; 

UINT (*AddRef) (PIVMSPACE This) ; 

UINT (*Release) (PIVMSPACE This) ; 

SCODE (*Reserve) (PIVMSPACE This, VM_OFFSET Offset, 
VM_SIZE Size) ; 

/* Delete mappings on range. Also unreserve if flag set 

*/ 

SCODE (*Delete) (PIVMSPACE This, VM_OFFSET Offset, 
VM_SIZE Size, 

BOOL Unreserve) ; 

/* Map backing store into address space. CopyMapping is 
used only 

* with VM_WRITECOPY. The flags are ored with those 
already in place, 

* thus it is ok to vs->Protect before mapping (XXX Is 
this useful?) . 

*/ 

SCODE (*Map) (PIVMSPACE This, VM_OFFSET Offset, VM_SIZE 
Size, 

PIVMMAPPING Mapping, PIVMMAPPING CopyMapping, 
VM_ FLAGS Flags) ; 

/* Set protection or other permanent attributes */ 
/* Recurse removes atomicity and affects only certain 
attributes : 

* namely VM_WIRE, VM_NOCACHE. 
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* Treat Attributes as mask to be set (Set=TRUE) or 
unset (Set=FALSE) . 
*/ 

SCODE (^Protect) (PIVMSPACE This, VM_0FFSET Offset, 
5 VM_SIZE Size, 

VM FLAGS Attributes, BOOL Set, BOOL Recurse); 



/* Set non-permanent attributes */ 



10 



15 



20 



# define VM_C AC H E_C L E AN 1 

#define VM_CACHE_FLUSH 2 
cleaning them */ 

#define VM_CACHE_DISCARD 3 
cleaning */ 

#define VM_CACHE_READ 4 

#define VM_CACHE_WRITE 5 

#define VM_CACHE_COPY 6 

# define VM_CACHE_UNMARK 7 
unused */ 

#define VM_CACHE_SWEEP 8 
untouched pages */ 



/* write out dirty pages */ 
/* throw away pages after 

/* throw away all pages w/o 

/* emulate read fault */ 

/* emulate write fault */ 

/* realize copy on writes */ 

/* Pseudo-LRU: mark pages 

/* Pseudo-LRU: throw away 

/* SWEEP is same as FLUSH 



25 



for unmarked pages */ 

SCODE (*CacheControl) (PIVMSPACE This, VM_OFFSET Offset, 
VM_SIZE Size, 

UINT Action, BOOL Recurse) ; 



/* vm_regions: Return info from region at or beyond 
offset */ 

/* Besides This and pOffset the arguments may be NULL */ 
30 SCODE (*QueryVM) (PIVMSPACE This, VM_OFFSET 

*pOffset/*in/out*/, 

VM_SIZE *pSize, VM_ FLAGS *pFlags, 
PIVMMAPPING *pMapping, PIVMMAPPING 
*pCopyMapping) ; 

103 



Microsoft Docket No. 116650.7 



/* Create New; move regs from This into New; map New 
into This w/ Flags. 

* If Flags indicate COW then copies are paged to 
5 CopyMapping. 
*/ 

SCODE (*CreateShadow) (PIVMSPACE This, VM_OFFSET Offset, 
VM_SIZE Size, 

PIVMMAPPING CopyMapping, VM_ FLAGS Flags, 
10 PIVMSPACE *pNew) ; 

In- 
struct IVmSpace { 

CONST_VTBL struct VMSpaceVtbl *v; 

15 } ; 

extern const IID IIDIVmSpace; 



/* VMView interface 

20 */ 

#if defined ( cplusplus) && ! defined (CINTERFACE) 

#else 

typedef struct IVmView *PIVMVIEW; 
typedef struct IVmMapping *PIVMMAPPING; 

25 

struct VMViewVtbl { 

SCODE (*QueryInterface) (PIVMVIEW This, REFIID lid, void 
**ppObject) ; 

UINT (*AddRef) (PIVMVIEW This) ; 
30 UINT (*Release) (PIVMVIEW This) ; 

/* SwitchTo is called from context switch path */ 
SCODE (*SwitchTo) (PIVMVIEW This) ; 
/* Fault is called at pagefault time */ 
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SCODE (*Fault) (PIVMVIEW This, ADDRESS FaultAddr, UINT 
Access) ; 

SCODE (*SetMapping) (PIVMVIEW This, PIVMMAPPING Mapping) ; 

SCODE (*GetMapping) (PIVMVIEW This, PIVMMAPPING 
*pMapping) ; 
}; 

struct IVmView { 

CONST_VTBL struct VMViewVtbl *v; 

}; 

#endif /* cplusplus */ 

extern const IID IID_IVmView; 

/* VM constructor interface 

*/ 

#if defined ( cplusplus) && ! defined (CINTERFACE) 

#else 

typedef struct IVmFactory *PIVMFACTORY; 

struct VmFactoryVtbl { 

SCODE (*QueryInterface) (PIVMFACTORY This, REFIID lid, 
void **ppObject) ; 

UINT (*AddRef) (PIVMFACTORY This); 

UINT (*Release) (PIVMFACTORY This); 

SCODE (*CreateVmView) (PIVMFACTORY This, PIVMVIEW *pVV) ; 
SCODE (*CreateVmSpace) (PIVMFACTORY This, PIVMSPACE 
*pVS) ; 

SCODE (*CreateVmMappingFromFile) (PIVMFACTORY This, 
PIFILE File, PIVMMAPPING *pNewMapping) ; 

SCODE (*CreateVmMappingFromZero) (PIVMFACTORY This, 
PIVMMAPPING *pNewMapping) ; 
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SCODE (*CreateDefault) ( PI VMFACTORY This, ADDRESS Where, 
VM_SIZE Size, PIVMVIEW *pVV) ; 



5 struct IVmFactory { 

CONST_VTBL struct VmFactoryVtbl *v; 

}; 

#endif /* cplusplus */ 

10 extern const IID IID_IVmFactory; 
#endif /* MMVM H */ 



APPENDIX D: 

The following is a header file for the basic features of 
MMLite. This file contains all the basic interfaces and 
30 services of the MMLite "kernel", including the NameSpace. 
The NameSpace is the one that implements the on-demand 
loading programming 



}; 



15 



20 



25 
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paradigm. The Register () method is used to add objects to 
the namespace and the 

Bind() method is used to look them up. The IHeap is the 
interface that applications use to request memory 
5 allocations (with or without VM) . There are also other 
functions that are not defined as part of a specific 
interface. Among these, AddDeviceO is the one used to 
install the VM and IPC trap handlers. 

10 As for additional interfaces, the VM manager uses the IVTLB 
interface. The primitives defined in mmbase.h (for Mutex_* 
and Condition_*, and for constraints) are sufficient in the 
general case. 

15 #ifndef _MMBASE_H_ 
#define _MMBASE_H_ 

/************* Constraint ****************/ 
#define CRITICAL ( 1 ) /* size is 4 */ 

20 #define NONCRITICAL ( 0 ) /* size is 4 */ 

typedef /* [transmit] */ INT CRITICALITY; /* size is 



#if defined ( cplusplus) 

25 /* work-around VC++ bug that produces warning 4705 */ 
typedef struct __TIME_CONSTRAINT { 

inline _TIME_CONSTRAINT ( ) { } ; 

inline ~ TIME CONSTRAINT ( ) {}; 



4 */ 



TIME 



Start; 



30 



TIME Estimate; 
TIME Deadline; 
CRITICALITY Criticality; 



} TIME CONSTRAINT, *PTIME_CONSTRAINT; 
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#else 

typedef struct _TIME_CONSTRAINT /* size is 28 */ 

{ 

TIME Start; 
5 TIME Estimate; 

TIME Deadline; 
CRITICALITY Criticality; 
} TIME_CONSTRAINT; 

10 /* size is 4 */ 

typedef struct _TIME_CONSTRAINT *PTIME_CONSTRAINT; 
#endif /* cplusplus */ 

% 13 /************* Mutex ****************/ 

j« 15 #if defined ( cplusplus) 

1'iJ /* work-around VC++ bug that produces warning 4705 */ 

|;i typedef struct _MUTEX { 

(jj inline _MUTEX() { } ; 

\ m _ inline ~_MUTEX() {}; 

j,j 20 UINT _mutex_state [MUTEX_STATE_SIZE] ; 

|:J } MUTEX, *PMUTEX; 

3.* 

#else 

typedef struct _MUTEX { /* size is 4 */ 

UINT _mutex_state [ 1 ] ; 
25 } MUTEX; 

typedef struct _MUTEX *PMUTEX; /* size is 4 */ 

#endif /* cplusplus */ 

3q /************* Condition ****************/ 
#if defined ( cplusplus) 

/* work-around VC++ bug that produces warning 4705 */ 
typedef struct _CONDITION { 
inline _CONDITION() {}; 
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inline ~_C0NDITI0N ( ) { } ; 

UINT _cond_state[CONDITION_STATE_SIZE] ; 
} CONDITION, *PCONDITION; 
#else 

5 typedef struct _CONDITION { /* size is 8 */ 

UINT _cond_state [ 2 ] ; 
} CONDITION; 

typedef struct _CONDITION *PCONDITION; /* size is 8 */ 

10 #endif /* cplusplus */ 

typedef interface IProcess IProcess; 
typedef interface IThread IThread; 

15 

namesp . h 

#if defined ( cplusplus) 

extern "C" { 

20 #endif /* cplusplus */ 

typedef interface INameSpace INameSpace; 

typedef UINT NAME_SPACE_FLAGS; 

#define NAME_S PACE_READ ( 0x1 ) 

25 #define NAME_SPACE_WRITE ( 0x2 ) 

#define NAME_SPACE_CREATE ( 0x10 ) 

#define NAME_S PACE_FAI LI FEX I ST ( 0x20 ) 

#define N AME_S PACE_EXT EN S I ON ( 0x800 ) 

30 typedef struct INameSpaceVtbl { 

SCODE ( MCT *QueryInterface ) ( 
INameSpace *This, 
/* [in] */ REFIID lid, 
/* [out] */ void **ppObject) ; 
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UINT ( MCT *AddRef ) ( 
INameSpace *This); 

5 UINT ( MCT *Release ) ( 

INameSpace *This) ; 

SCODE ( MCT *Register ) ( 
INameSpace *This, 
10 CTSTR pName, 

IUnknown *pObj , 
NAME_SPACE_FLAGS Flags, 
INameSpace *pServerNameSpace) ; 

15 SCODE ( MCT *Unregister ) ( 

INameSpace *This, 
CTSTR pName) ; 

SCODE ( MCT *Bind ) ( 
20 INameSpace *This, 

CTSTR pName, 
NAME_SPACE_FLAGS Flags, 
/* [out] */ IUnknown **ppUnk) ; 

25 SCODE ( MCT *FindFirst ) ( 

INameSpace *This, 
CTSTR pPrefix, 

/* [size_is] [out] */ TSTR pBuffer, 
/* [in] */ UINT BufSize, 
30 /* [out] */ UINT *pStrLen) ; 

SCODE ( MCT *FindNext ) ( 
INameSpace *This, 
CTSTR pPrefix, 
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CTSTR pPrevious, 

/* [size_is] [out] */ TSTR pBuffer, 
/* [in] */ UINT BufSize, 
/* [out] */ UINT *pStrLen); 

SCODE ( MCT *GetCapabilities ) ( 
INameSpace *This, 
CTSTR pName, 

/* [out] */ NAME_SPACE_FLAGS *pFlags) ; 
} INameSpaceVtbl; 
#if defined ( cplusplus) && ! defined (CINTERFACE) 



15 interface INameSpace : public IUnknown 

{ 

public: 

virtual SCODE MCT Register ( 
CTSTR pName, 
20 IUnknown *pOb j , 

NAME_S PACE_FLAGS Flags, 
INameSpace *pServerNameSpace) = 0; 

virtual SCODE MCT Unregister( 
25 CTSTR pName) = 0; 

virtual SCODE MCT Bind ( 
CTSTR pName, 
NAME_SPACE_FLAGS Flags, 
30 /* [out] */ IUnknown **ppUnk) = 0; 

virtual SCODE MCT FindFirst ( 
CTSTR pPrefix, 

/* [size_is] [out] */ TSTR pBuffer, 
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/* [in] */ UINT BufSize, 

/* [out] */ UINT *pStrLen) = 0; 

virtual SCODE MCT FindNext ( 
5 CTSTR pPrefix, 

CTSTR pPrevious, 

/* [size_is] [out] */ TSTR pBuffer, 

/* [in] */ UINT BufSize, 

/* [out] */ UINT *pStrLen) = 0; 

10 

virtual SCODE MCT GetCapabilities ( 
CTSTR pName, 

/* [out] */ NAME_SPACE_FLAGS *pFlags) = 0; 

15 }; 

#else /* cplusplus */ /* C style interface */ 

interface INameSpace 
20 { 

CONST_VTBL struct INameSpaceVtbl *lpVtbl; 
}; 

#endif /* cplusplus */ /* C style interface */ 

25 

#if defined ( cplusplus) 

} 

#endif /* cplusplus */ 

/******** heap.h ********/ 

30 

#if defined ( cplusplus) 

extern "C"{ 

#endif /* cplusplus */ 
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typedef interface IHeap IHeap; 

#define HEAP_NO_SERIALIZE ( 0x1 ) 

#define HEAP_NO_COPY (0x4) 

#define HEAP_ZERO_MEMORY ( 0x8 ) 

5 #define HEAP_REALLOC_IN_PLACE_ONLY ( 0x10 ) 

#define HEAP CACHE ALIGN ( 0x100 ) 



typedef struct IHeapVtbl { 

SCODE ( MCT *QueryInterface ) ( 
10 IHeap *This, 

/* [in] */ REFIID lid, 

/* [out] */ void **ppObject); 



UINT ( MCT *AddRef ) ( 
15 IHeap *This) ; 

UINT ( MCT *Release ) ( 
IHeap *This) ; 

20 PTR ( MCT *Alloc ) ( 

IHeap *This, 
UINT Flags, 
UINT Size, 
UINT Alignment) ; 

25 

PTR ( MCT *ReAlloc ) ( 
IHeap *This, 
UINT Flags, 
PTR pMem, 
30 UINT NewSize, 

UINT Alignment); 



BOOL ( MCT *Free ) ( 
IHeap *This, 
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UINT Flags, 
PTR pMem) ; 



ADDR_SIZE ( MCT *Size ) ( 
5 IHeap *This, 

UINT Flags, 
PTR pMem) ; 

BOOL ( MCT *Validate ) ( 
10 IHeap *This, 

UINT Flags, 
PTR pMem) ; 



PTR 

15 



( MCT *Extract ) ( 
IHeap *This, 
UINT Flags, 
PTR pMem, 
UINT Size) ; 



20 SCODE ( MCT *Status ) ( 

IHeap *This, 
ADDR_SIZE *pReserve, 
ADDR_SIZE *pCommit, 
ADDR_SIZE *pUsed, 

25 ADDR_SIZE *pMaxUsed) ; 



} IHeapVtbl; 



#if defined ( cplusplus) && ! defined (CINTERFACE) 

30 interface IHeap : public IUnknown { 
public: 

virtual PTR MCT Alloc ( 
UINT Flags, 
UINT Size, 
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UINT Alignment) = 0; 

virtual PTR MCT ReAlloc( 
UINT Flags, 
5 PTR pMem, 

UINT NewSize, 

UINT Alignment) = 0; 

virtual BOOL MCT Free ( 
10 UINT Flags, 

PTR pMem) = 0; 

virtual ADDR_SIZE MCT Size( 
UINT- Flags, 
15 PTR pMem) = 0; 

virtual BOOL MCT Validate ( 
UINT Flags, 
PTR pMem) = 0; 



20 



25 



virtual PTR MCT Extract ( 
UINT Flags, 
PTR pMem, 
UINT Size) = 0; 



virtual SCODE MCT Status ( 
ADDR_SIZE *pReserve, 
ADDR_SIZE *pCommit, 
ADDR_SIZE *pUsed, 
30 ADDR_SIZE *pMaxUsed) = 0; 

}; 

#else /* C style interface */ 
interface IHeap { 
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CONST_VTBL struct IHeapVtbl *lpVtbl; 

}; 

#endif /* cplusplus */ /* C style interface */ 

#if defined ( cplusplus) 

5 } 

#endif /* cplusplus */ 

/******** module . h ********/ 

#if defined ( cplusplus) 

extern "C"{ 
10 #endif /* cplusplus */ 



III 



typedef interface IModule IModule; 
typedef struct IModuleVtbl { 

SCODE ( MCT *QueryInterface ) ( 
15 IModule *This, 

/* [in] */ REFIID lid, 

/* [out] */ void **ppObject) ; 

UINT ( MCT *AddRef ) ( 
20 IModule *This) ; 



M3 UINT ( MCT *Release ) ( 

* 13 IModule *This) ; 



25 SCODE ( MCT *Get FunctionAddress ) ( 

IModule *This, 
CTSTR Name, 
UINT Ordinal, 

/* [out] */ ADDRESS *pAddress) ; 

30 

SCODE ( MCT *GetName ) ( 
IModule *This, 

/* [size_is] [out] */ TSTR Buffer, 
/* [in] */ UINT BufSize); 
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SCODE ( MCT *GetArgs ) ( 
IModule *This, 

/* [size_is] [out] */ TSTR Buffer, 
5 /* [in] */ UINT BufSize); 

SCODE ( MCT *GetLocation ) ( 
IModule *This, 

/* [out] */ ADDRESS *pAddress, 
10 /* [out] */ UINT *pSize) ; 

SCODE ( MCT *GetEntryPoint ) ( 
IModule *This, 

/* [out] */ ADDRESS *pEntry) ; 

} IModuleVtbl; 

#if defined! cplusplus) && ! defined (CINTERFACE) 

interface IModule : public IUnknown 
{ 

public: 

virtual SCODE MCT GetFunctionAddress ( 
CTSTR Name, 
UINT Ordinal, 

/* [out] */ ADDRESS *pAddress) = 0; 

virtual SCODE MCT GetName ( 

/* [size_is] [out] */ TSTR Buffer, 
/* [in] */ UINT BufSize) = 0; 
30 

virtual SCODE MCT GetArgs ( 

/* [size_is] [out] */ TSTR Buffer, 
/* [in] */ UINT BufSize) = 0; 
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virtual SCODE MCT GetLocation ( 

/* [out] */ ADDRESS *pAddress, 
/* [out] */ UINT *pSize) = 0; 

virtual SCODE MCT GetEntryPoint ( 

/* [out] */ ADDRESS *pEntry) = 0; 

}; 

#else /* C style interface */ 
interface IModule 
{ 

CONST_VTBL struct IModuleVtbl *lpVtbl; 
}; 

#endif /* cplusplus */ /* C style interface */ 

#if defined ( cplusplus) 

} 

#endif /* cplusplus */ 

/******** proces.h ********/ 

#if defined ( cplusplus) 

extern "C" { 

#endif /* cplusplus */ 

typedef interface IProcess IProcess; 

typedef /* [transmit] */ void *THREAD_ARGUMENT; 

#if 0 

typedef /* [transmit] */ void ( stdcall *THREAD_FUNCTION 

) ( 

THREAD_ARGUMENT arg) ; 
#else 

/* Include THREAD_LINKAGE linkage specification in C/C++ 
declaration */ 
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typedef void (THREAD_LINKAGE * THREAD_FUNCT I ON 

) (THREAD_ARGUMENT arg) ; 

#endif 

5 typedef struct _MACHINE_INFO { 
UINT32 Machineld; 
UINT32 OEMId; 

UINT TotalPhysicalMemory; 
UINT AvailablePhysicalMemory; 
10 UINT Reserved [ 12 ] ; 

} MACHINE_INFO; 

typedef UINT MACH I N E_ I N FO_FLAVOR ; 
#define MACHINE_KIND_GENERIC ( 0x01 ) 
15 typedef struct IProcessVtbl { 

SCODE ( MCT *QueryInterface ) ( 
IProcess *This, 
/* [in] */ REFIID lid, 
/* [out] */ void **ppObject ) ; 

20 

UINT ( MCT *AddRef ) ( 
IProcess *This); 

UINT ( MCT *Release ) ( 
25 IProcess *This) ; 

SCODE ( MCT *CreateThread ) ( 
IProcess *This, 
THREAD_FUNCTION pStart, 
30 THREAD_ARGUMENT Arg, 

ADDR_SIZE StackSize, 
void *Reserved, 

/* [out] */ IThread **ppNewThread) ; 
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SCODE ( MCT *LoadImage ) ( 
IProcess *This, 
CTSTR plmage, 
CTSTR pArgs, 
5 /* [out] */ IModule **ppIModule) ; 

SCODE ( MCT *Init ) ( 
IProcess *This, 
ADDR_SIZE StackSize, 
10 void *compat); 

SCODE ( MCT *MachineInfo ) ( 
IProcess *This, 
MACHINE_INFO_FLAVOR Kind, 
15 /* [out] */ MACHINE_INFO *pInfo) ; 

} IProcessVtbl; 

#if defined ( cplusplus) && ! defined (CINTERFACE) 

20 

interface IProcess : public IUnknown 
{ 

public: 

virtual SCODE MCT CreateThread ( 
25 THREAD_FUNCTION pStart, 

THREAD_ARGUMENT Arg, 
ADDR_SIZE StackSize, 
void *Reserved, 

/* [out] */ IThread **ppNewThread) = 0; 



30 



virtual SCODE MCT Loadlmage ( 
CTSTR plmage, 
CTSTR pArgs, 

/* [out] */ IModule **ppIModule) = 0; 
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virtual SCODE MCT Init ( 
ADDR_SIZE StackSize, 
void *compat) = 0; 

5 

virtual SCODE MCT Machinelnf o ( 
MAC H I N E_ I N FO_ FLAVOR Kind, 
/* [out] */ MACHINE_INFO *pInfo) = 0; 

10 }; 

#else /* C style interface */ 

interface IProcess 
15 { 

CONST_VTBL struct IProcessVtbl *lpVtbl; 

}; 

#endif /* cplusplus */ /* C style interface */ 

20 #if defined ( cplusplus) 

} 

#endif /* cplusplus */ 

/******** thread. h ********/ 

#if defined ( cplusplus) 

25 extern "C"{ 

#endif /* cplusplus */ 

typedef interface IThread IThread; 
typedef struct IThreadVtbl { 

SCODE ( MCT *QueryInterface ) ( 
30 IThread *This, 

/* [in] */ REFIID lid, 

/* [out] */ void **ppObject) ; 



UINT ( MCT *AddRef ) ( 
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IThread *This) ; 

UINT ( MCT ^Release ) ( 
IThread *This) ; 

5 

SCODE ( MCT *GetProcess ) ( 
IThread *This, 

/* [out] */ IProcess **ppIProcess) ; 

10 } IThreadVtbl; 

#if defined ( cplusplus) && ! defined (CINTERFACE) 

interface IThread : public IUnknown 
15 { 

public: 

virtual SCODE MCT GetProcess ( 

/* [out] */ IProcess **ppIProcess) = 0; 

20 }; 

#else /* C style interface */ 

interface IThread 
25 { 

CONSTJVTBL struct IThreadVtbl *lpVtbl; 
}; 

#endif /* cplusplus */ /* C style interface */ 

30 #if defined! cplusplus) 

} 

#endif /* cplusplus */ 



EXTERN_C ADDRESS RTLCALLTYPE GetPC(void); 
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/* 

* Current object 
*/ 

5 

EXTERN_C PITHREAD RTLCALLTYPE CurrentThread (void) ; 
EXTERN_C PIPROCESS RTLCALLTYPE Current Process (void) ; 
EXTERN_C PINAMESPACE RTLCALLTYPE CurrentNameSpace (void) ; 
EXTERN_C PIHEAP RTLCALLTYPE ProcessHeap ( void) ; /* same as 
10 CurrentHeap */ 

EXTERN_C TSTR RTLCALLTYPE Process Image ( void) ; 
EXTERN_C TSTR RTLCALLTYPE ProcessArgs (void) ; 
EXTERN_C PIVMVIEW RTLCALLTYPE CurrentVmView ( void) ; 

15 /* Atomic 
*/ 

OSRTL(BOOL) AtomicCmpAndSwap (PUINT pTarget, UINT OldVal, 
UINT NewVal) ; 

OSRTL(UINT) At omicAdd (PUINT pTarget, UINT Cnt); 
20 OSRTL(UINT) AtomicSub ( PUINT pTarget, UINT Cnt); 

OSRTL(UINT) AtomicDec (PUINT pTarget); 

OSRTL(UINT) Atomiclnc (PUINT pTarget); 

OSRTL(UINT) AtomicSwap( PUINT pTarget, UINT NewVal); 

OSRTL(void) AtomicLIFOInsert (PTR * RESTRICT pHead, PTR 
25 RESTRICT Item) ; 

OSRTL (PTR) AtomicLIFORemove (PTR *pHead) ; 



/* Mutex 
*/ 



30 OSRTL (void) Mutex_Init ( PMUTEX pmx) ; 

OSRTL(void) Mutex_Destroy (PMUTEX pmx) ; 

OSRTL (void) Mutex_Lock( PMUTEX pmx) ; 

OSRTL(void) Mutex_Unlock ( PMUTEX pmx) ; 

OSRTL (BOOL) Mutex_TryLock ( PMUTEX pmx) ; 
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OSRTL(BOOL) Mutex_Locked (const MUTEX *pmx) ; 

/* Condition 
*/ 

OSRTL(void) Condition_Init (PCONDITION pcnd); 
OSRTL(void) Condition_Destroy (PCONDITION pcnd); 
OSRTL(void) Condition_Signal (PCONDITION pcnd); 
OSRTL(BOOL) Condition_InterruptSignal ( PCONDITION pcnd); 
OSRTL(void) Condition_Broadcast (PCONDITION pcnd); 
OSRTL(void) Condition_Wait (PCONDITION pcnd, PMUTEX pmx) ; 
OSRTL(SCODE) Condition_TimedWait ( PCONDITION pcnd, PMUTEX 
pmx, TIME tout) ; 

OSRTL(SCODE) Condition_WaitAndBeginConstraint (PCONDITION 
pcnd, PMUTEX pmx, BOOL endprev, PTIME_CONSTRAINT pcval, 
PTIME pttaken) ; 
OSRTL (SCODE) 

Condition_TimedWaitAndBeginConstraint (PCONDITION pcnd, 
PMUTEX pmx, TIME until, BOOL endprev, PTIME_CONSTRAINT 
pcval, PTIME pttaken); 

/* Constraint 
*/ 

OSRTL (SCODE) BeginConstraint (BOOL endprev, PTIME_CONSTRAINT 
pcval, PTIME pttaken); 

OSRTL (SCODE) EndConstraint (PTIME pttaken); 

/* Module 
*/ 

OSRTL (SCODE) GetModuleNext (PIMODULE Previous, PIMODULE 
*ppIModule) ; 

OSRTL (SCODE) GetModuleContainsAddr (ADDRESS Addr, PIMODULE 
*ppIModule) ; 

#def ine GetCurrentModule (_ppIModule_) 
GetModuleContainsAddr (GetPC ( ) , _ppIModule_) 
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/* Compare two UUIDs. Returns TRUE if they are same, FALSE 
otherwise . 
*/ 

5 OSRTL(BOOL) UuidCmp (const UUID *pUuidl, const UUID *pUuid2) ; 
#define IidCmp (plidl, plid2) 
UuidCmp ( (PUUID)pIidl, (PUUID) plid2) 
#define IpidCmp (plpidl, plpid2 ) 
UuidCmp ( (PUUID) plpidl, (PUUID) plpid2) 

10 

/* Various constructors. 
*/ 

OSRTL(PIHEAP) HeapCreate (ADDRESS Mem, UINT InitSize, UINT 
MaxSize, UINT Flags) ; 
15 OSRTL ( IHeap* ) CreateHeap (UINT Flags, ADDR_SIZE InitialSize, 
ADDR_SIZE MaxSize) ; 

/* Others 
*/ 

20 EXTERN_C SCODE WINAPI GetLastError ( void) ; 

EXTERN_C void WINAPI SetLastError (SCODE Error); 

OSRTL (SCODE) AddDevice ( PTR Device, PTR Isr, UINT ArgO, UINT 
Argl, UINT Arg2) ; 
25 #define RemoveDevice (_dev_,_irq_) 
AddDevice (_dev_,NULL, 0,_irq_, 0) 
OSRTL (SCODE) SleepUntil (TIME Until); 
OSRTL(void) Delay(UINT Microseconds); 

OSRTL (SCODE) GenericQuerylnterf ace ( IUnknown *pThis, REFIID 
30 IidQuery, void **ppObject, REFIID Iidlnterface) ; 
EXTERN_C void CRTAPI WaitFor ( IUnknown *pUnk) ; 

OSRTL (void) ThreadExit (void) ; 
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OSRTL (TIME) CurrentTime (void) ; 

EXTERN_C int CRTAPI memcmp (const void *, const void *, 
unsigned) ; 

EXTERN_C void * CRTAPI memcpy ( void *, const void *, 
unsigned) ; 

EXTERN_C void * CRTAPI memset (void *, int, unsigned); 
EXTERN_C void * CRTAPI memmove ( void *, const void *, 
unsigned) ; 

EXTERN_C size_t CRTAPI strlen(const char *) ; 
EXTERN_C int CRTAPI strcmp(const char *, const char *) ; 
EXTERN_C char *CRTAPI strcpy(char *, const char *) ; 
EXTERN_C char *CRTAPI strcat(char *, const char *) ; 

#endif /* _MMBASE_H_ */ 
APPENDIX E: 

The following is a file for reading the foregoing 
header files of Appendices A-D. 

Explanations are provided with the code. 



#if defined( cplusplus) 

extern "C" { 

#endif /* cplusplus */ 

This file is common to two programming languages, C and 
C++. Ignore 
this clause. 

typedef interface ILoadablelPC ILoadablelPC; 

Announce that we will define an ILoadablelPC interface, 

later on. 
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typedef struct ILoadablelPCVtbl { 

This is the VTable definition for our interface, it is 
only used in 
5 the C language. But it 

is exposed to C++ users as well, in case they need it. 

SCODE ( MCT *QueryInterface ) ( 
ILoadablelPC *This, 
10 /* [in] */ REFIID lid, 

/* [out] */ void **ppObject) ; 

This is the standard Querylnterf ace method, as required 
by the base 
IUnknown interface. 

15 

UINT ( MCT *AddRef ) ( 
ILoadablelPC *This) ; 
Ditto for AddRef () 

20 UINT ( MCT *Release ) ( 

ILoadablelPC *This) ; 
..and for Release (). 

SCODE ( MCT *TrapHandler ) ( 
25 ILoadablelPC *This, 

PCXTINFO pThreadState 
) ; 

We are done with the IUnknown, this method is now 
specific to our 
30 interface definition. 

} ILoadablelPCVtbl; 

End of the VTable definition. 
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#if defined( cplusplus) && ! defined (CINTERFACE) 

The following defines the ILoadablelPC interface for 
users of the 
C++ language 
5 interface ILoadablelPC : public IUnknown 

In C++ we just say that we "derive" from the IUnknown and 
the 

compiler will define 

the basic methods for us, automatically. 
10 { 

public: 

virtual SCODE MCT TrapHandler ( 
PCXTINFO pThreadState 
) = 0; 

15 We just define our specific method. Infact, this portion 

between 

#if and #else is 

the only one that is strictly needed for a C++ uses. 
Most of the 
20 stuff in here is for 

the benefit of the C programmer. 
}; 

#else /* cplusplus / / C style interface */ 

25 

interface ILoadablelPC 
{ 

CONST_VTBL struct ILoadablelPCVtbl *lpVtbl; 
For the C language we define an interface as something 
30 that just 

contains the VTable pointer 

to the object's method. The object's state will actually 
follow in 
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memory the lpVtbl pointer. 
}; 

#endif /* cplusplus / / C style interface */ 

5 

#if defined ( cplusplus) 

} 

#endif /* cplusplus */ 
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